home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / COMPRESS / SS101.ARJ / SS.DOC < prev    next >
Text File  |  1992-04-15  |  105KB  |  3,101 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                      ShapeShifter(tm)  Archive Conversion System
  30.  
  31.                           Copyright (c)1992 By Curtis Little
  32.  
  33.                                  All Rights Reserved
  34.  
  35.  
  36.  
  37.                        "Software Solutions That Make Sense"(tm)
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                   Table of Contents
  47.  
  48.  
  49.  
  50.  
  51.           License . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  52.  
  53.           Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  54.  
  55.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   6
  56.                Acknowledgments  . . . . . . . . . . . . . . . . . . . .   6
  57.                How to Contact the Support Board . . . . . . . . . . . .   6
  58.                Required Equipment . . . . . . . . . . . . . . . . . . .   6
  59.  
  60.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   7
  61.                Overview of ShapeShifter . . . . . . . . . . . . . . . .   7
  62.                ShapeShifter Features  . . . . . . . . . . . . . . . . .   7
  63.                Registering ShapeShifter . . . . . . . . . . . . . . . .   9
  64.                Using a Mouse  . . . . . . . . . . . . . . . . . . . . .   9
  65.                     Selecting menu items with a mouse . . . . . . . . .   9
  66.                     Selecting an input field with a mouse . . . . . . .   9
  67.                     Exiting an input screen with a mouse  . . . . . .    10
  68.                     Using a mouse on dialog boxes . . . . . . . . . .    10
  69.                Starting ShapeShifter  . . . . . . . . . . . . . . . .    10
  70.                ShapeShifter Command Line Options  . . . . . . . . . .    11
  71.                Specifying On/Off Options  . . . . . . . . . . . . . .    12
  72.  
  73.           ShapeShifter Option Descriptions  . . . . . . . . . . . . .    13
  74.                Archiver Name  . . . . . . . . . . . . . . . . . . . .    13
  75.                Author Verification  . . . . . . . . . . . . . . . . .    14
  76.                Bad files directory  . . . . . . . . . . . . . . . . .    14
  77.                Command to Execute After All Conversions Are Complete     15
  78.                Command to execute after creating an archive with this
  79.                     archiver  . . . . . . . . . . . . . . . . . . . .    15
  80.                Command to execute before beginning the conversion
  81.                     session . . . . . . . . . . . . . . . . . . . . .    16
  82.                Command to execute before creating an archive with this
  83.                     archiver  . . . . . . . . . . . . . . . . . . . .    17
  84.                Command to execute before extracting an archive with
  85.                     this archiver . . . . . . . . . . . . . . . . . .    17
  86.                Convert archives containing subdirs  . . . . . . . . .    18
  87.                Convert to . . . . . . . . . . . . . . . . . . . . . .    18
  88.                Create Command . . . . . . . . . . . . . . . . . . . .    18
  89.                Create list of files converted . . . . . . . . . . . .    19
  90.                Date Stamping Method . . . . . . . . . . . . . . . . .    19
  91.                Dir File(s)  . . . . . . . . . . . . . . . . . . . . .    20
  92.                Dir Type . . . . . . . . . . . . . . . . . . . . . . .    20
  93.                Extension  . . . . . . . . . . . . . . . . . . . . . .    22
  94.                Extract Command  . . . . . . . . . . . . . . . . . . .    22
  95.                File Attributes  . . . . . . . . . . . . . . . . . . .    22
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                File Start,Len . . . . . . . . . . . . . . . . . . . .    23
  104.                Keep original archive  . . . . . . . . . . . . . . . .    23
  105.                Log File . . . . . . . . . . . . . . . . . . . . . . .    24
  106.                Logging Level  . . . . . . . . . . . . . . . . . . . .    24
  107.                Max age of files to convert  . . . . . . . . . . . . .    25
  108.                Memory to make available . . . . . . . . . . . . . . .    26
  109.                Preserve Author Verified files . . . . . . . . . . . .    26
  110.                R. Just  . . . . . . . . . . . . . . . . . . . . . . .    26
  111.                Recurse Archives . . . . . . . . . . . . . . . . . . .    27
  112.                Recurse Subdirs  . . . . . . . . . . . . . . . . . . .    27
  113.                Redirect I/O . . . . . . . . . . . . . . . . . . . . .    28
  114.                Redo archives that are already the target type . . . .    29
  115.                Save Converted List in . . . . . . . . . . . . . . . .    29
  116.                Scanner Command  . . . . . . . . . . . . . . . . . . .    29
  117.                Scanner supports subdirs . . . . . . . . . . . . . . .    30
  118.                Size Start,Len . . . . . . . . . . . . . . . . . . . .    31
  119.                Strip attributes (HSR) . . . . . . . . . . . . . . . .    31
  120.                SubDirs  . . . . . . . . . . . . . . . . . . . . . . .    32
  121.                Switch! to EMS . . . . . . . . . . . . . . . . . . . .    32
  122.                Switch! to XMS . . . . . . . . . . . . . . . . . . . .    33
  123.                Test Only  . . . . . . . . . . . . . . . . . . . . . .    33
  124.                Update BBS/Dir File With New Extension and Size  . . .    33
  125.                Use 43/50 Line Mode  . . . . . . . . . . . . . . . . .    34
  126.                Use Switch!  . . . . . . . . . . . . . . . . . . . . .    34
  127.                Use Virus Scanner  . . . . . . . . . . . . . . . . . .    36
  128.  
  129.           Appendices  . . . . . . . . . . . . . . . . . . . . . . . .    37
  130.                Appendix A - How ShapeShifter Detects Corrupt
  131.                     Archives. . . . . . . . . . . . . . . . . . . . .    38
  132.                Appendix B - Archivers, Scanners, and User Programs
  133.                     Supported by ShapeShifter . . . . . . . . . . . .    40
  134.                Appendix C - ShapeShifter Error Messages . . . . . . .    41
  135.                Appendix D - Specifying Command Lines  . . . . . . . .    48
  136.                     Example Command Lines . . . . . . . . . . . . . .    49
  137.  
  138.           Index . . . . . . . . . . . . . . . . . . . . . . . . . . .    51
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.           License
  149.  
  150.           You are granted a nonexclusive personal right to use this
  151.           Software under the terms stated in this Agreement.  Unregistered
  152.           users are allowed to evaluate this software for a period NOT TO
  153.           EXCEED FIFTEEN (15) DAYS.  If, on or before this time expires,
  154.           you wish to continue using this software, you must register by
  155.           sending the registration fee to the author "Curtis Little" for
  156.           EACH COPY to be used.  You may not modify or alter the Software
  157.           or any of the accompanying files and/or documentation.  This
  158.           license is effective until terminated.  You may terminate it at
  159.           any time by destroying your copies of the Software.  It will also
  160.           terminate if you fail to comply with any term or condition of
  161.           this Agreement.  You agree upon such termination to destroy your
  162.           copies of the Software.
  163.  
  164.           The shareware version of this software may be freely distributed
  165.           as long as the following conditions are met:
  166.  
  167.                1)   All files are distributed as is and in unmodified form.
  168.  
  169.                2)   No more than a $5.00 handling fee can be charged
  170.                     without the express written consent of the author
  171.                     "Curtis Little".
  172.  
  173.                3)   This Software may not be distributed with or as a part
  174.                     of any other product or software package without the
  175.                     express written consent of the author "Curtis Little".
  176.  
  177.           Registered users may not transfer or assign ownership of this
  178.           license to any other person without the express written consent
  179.           of the author (Curtis Little).  Attempts to sublicense, assign,
  180.           or transfer any of the rights, duties, or obligations hereunder
  181.           is void.  You may not copy, modify, alter, electronically
  182.           transfer, or lease the registered version of this Software and
  183.           supporting files.  Registered owners may use this software on
  184.           more than one computer providing there is no possibility it will
  185.           be used on more than one computer at any one time.
  186.  
  187.           Business and government users of the Software are not allowed the
  188.           evaluation period.  Use in a business or government institution
  189.           without first paying the required registration fee is in
  190.           violation of this license agreement.
  191.  
  192.           By using the Software you acknowledge that you have read this
  193.           agreement, understand it and agree to be bound by it's terms and
  194.           conditions.
  195.  
  196.           4                                            ShapeShifter License
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.           Warranty
  208.  
  209.           With respect to the physical diskette sent to registered owners,
  210.           the author warrants the same to be free from defects in materials
  211.           and workmanship for a period of 60 days from the date of 
  212.           registration.  In the event of notification within the warranty
  213.           period of defects in material or workmanship the author will
  214.           replace the defective diskette.  The remedy for breach of this
  215.           warranty shall be limited to replacement and shall not encompass
  216.           any other damages, including but not limited to loss of profit,
  217.           and special, incidental, consequential, or other similar claims.
  218.  
  219.           The author specifically disclaims all other warranties, expressed
  220.           or implied, including but not limited to implied warranties of
  221.           merchantability and fitness for a particular purpose and the
  222.           program license granted herein in particular, and without
  223.           limiting operation of the program license with respect to any
  224.           particular application, use, or purpose.  IN NO EVENT SHALL THE
  225.           AUTHOR BE LIABLE FOR ANY LOSS OF PROFIT, LOST SAVINGS, COMMERCIAL
  226.           DAMAGE, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
  227.           OF THE USE OR INABILITY TO USE THIS SOFTWARE EVEN IF THE AUTHOR
  228.           (Curtis Little) OR AN AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED
  229.           OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER
  230.           PARTY.
  231.  
  232.           This agreement shall be governed by the laws of the state of
  233.           California.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.           ShapeShifter - User's Guide                                     5
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.           Getting Started
  266.  
  267.  
  268.           Acknowledgments
  269.  
  270.           In this manual several products are referred to:
  271.  
  272.                MS-DOS is a registered trademark of Microsoft Corporation.
  273.  
  274.                PKZIP & PKUNZIP are registered trademarks of PKWare, Inc.
  275.  
  276.                ARC is a registered trademark of SEA
  277.  
  278.                IBM PC, XT, AT, and PS/2 are trademarks of International
  279.                Business Machines, Inc.
  280.  
  281.  
  282.           How to Contact the Support Board
  283.  
  284.           An electronic bulletin board is used to support ShapeShifter. 
  285.           You may contact the support board 24 hours a day.  The support
  286.           board is:
  287.  
  288.                Lost At C BBS
  289.                (209) 521-2143
  290.  
  291.           You may also contact me via US mail at:
  292.  
  293.                2413 San Felipe Way
  294.                Modesto, CA  95355
  295.  
  296.           If you have any questions/suggestions regarding ShapeShifter feel
  297.           free to call or write.  The support board is open to the public,
  298.           however, registered users will receive priority service.
  299.  
  300.  
  301.           Required Equipment
  302.  
  303.                IBM PC, XT, AT, PS/2 or MS-DOS Compatible
  304.                MS-DOS 2.0 or above
  305.                At least 256K memory available to application programs
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.           6                                  ShapeShifter - Getting Started
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.            
  321.  
  322.  
  323.  
  324.           Introduction
  325.  
  326.           Overview of ShapeShifter
  327.  
  328.           ShapeShifter is a highly sophisticated program designed to make
  329.           the task of converting from one archive format to another an
  330.           effortless task.  ShapeShifter is also handy for scanning files
  331.           contained in archives for viral infections.  ShapeShifter sports
  332.           many options affording the user a great degree of flexibility
  333.           (ShapeShifter can even be set to automatically update BBS dir
  334.           files!).  Since ShapeShifter is designed to be used as a command
  335.           line utility, it can be used for unattended operation (unattended
  336.           operation is effectively available to registered users only due
  337.           to the opening delay screen).
  338.  
  339.           This manual is intended as more of a reference than a users
  340.           guide.  I don't expect that too many people are anxious to sit
  341.           down and read a long boring guide about a program when it's
  342.           relatively easy to make things work without doing so.  At a
  343.           minimum you may wish to read this section of the manual to learn
  344.           how to call ShapeShifter, and then refer to the reference section
  345.           of the manual when you desire to learn the specifics about a
  346.           certain field or error message.
  347.  
  348.           This section of the manual lists the major features supported by
  349.           ShapeShifter followed by brief instructions on the calling syntax
  350.           for ShapeShifter.  Later sections of the manual explain each of
  351.           ShapeShifter's options in detail.
  352.  
  353.  
  354.           ShapeShifter Features
  355.  
  356.           ShapeShifter's major features include the following:
  357.  
  358.                o    Mouse support
  359.  
  360.                o    Support for virtually all archive types both past and
  361.                     present.  The user may configure ShapeShifter to use
  362.                     future archive types in addition to adding support for
  363.                     types not configured at default.  (And I won't claim
  364.                     ShapeShifter is the only one to support this like some
  365.                     others do ;-)
  366.  
  367.  
  368.  
  369.  
  370.           ShapeShifter - User's Guide                                     7
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                o    Supports a user configured Virus Scanner.  The user has
  380.                     the freedom to determine which virus scanner (if any)
  381.                     should be used.  Even if your scanner doesn't support
  382.                     subdirs, ShapeShifter can properly handle it so even
  383.                     archives that do have subdirectories will have every
  384.                     file scanned!
  385.  
  386.                o    ShapeShifter not only can log information about the
  387.                     files converted, but it can also automatically update
  388.                     the BBS directory file(s) for virtually all BBS types
  389.                     available today.
  390.  
  391.                o    Supports author verified files created by PKZIP.  Since
  392.                     many authors (like myself) use PKZIPs -AV feature to
  393.                     certify authentic files, ShapeShifter was designed to
  394.                     not modify these files unless you specifically tell it
  395.                     too.
  396.  
  397.                o    ShapeShifter can run virtually all archiving programs
  398.                     to perform the conversion - including memory hogs that
  399.                     can't be run from other archive converters. 
  400.                     (ShapeShifter uses Switch! technology to free memory
  401.                     for the archivers that need it).
  402.  
  403.                o    Output of the archiver programs can be redirected (and
  404.                     *yes* this does include LHA!).
  405.  
  406.                o    Nested archives are no problem for ShapeShifter. 
  407.                     ShapeShifter can efficiently convert nested archives to
  408.                     the desired format.
  409.  
  410.                o    Provides full support of subdirectories in the
  411.                     archives.  If the archiver you're using supports
  412.                     subdirs, ShapeShifter can as well!
  413.  
  414.                o    Provides full support for file attributes (read only,
  415.                     hidden, and system).  If the archiver you're using
  416.                     supports attributes, ShapeShifter can as well!  If you
  417.                     desire, ShapeShifter can automatically strip file
  418.                     attributes during the conversion.
  419.  
  420.                o    43/50 line mode for EGA/VGA adapters is supported.
  421.  
  422.                o    ShapeShifter can recurse subdirs looking for files to
  423.                     convert, allowing simple conversion of every file on
  424.                     your computer's disk(s)!
  425.  
  426.  
  427.  
  428.           8                                     ShapeShifter - Introduction
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.                o    ShapeShifter allows a great deal of customization. 
  437.                     There are numerous options to control operation as well
  438.                     as hooks you can use to call your own programs to do
  439.                     things such as save archive comments before conversion,
  440.                     and then reinsert them after conversion!
  441.  
  442.           It's funny to note the list above doesn't scratch the surface of
  443.           ShapeShifter's power.  ShapeShifter clearly sets new standards
  444.           for archive conversion software.
  445.  
  446.  
  447.           Registering ShapeShifter
  448.  
  449.           ShapeShifter is *NOT* free software.  It is distributed as
  450.           shareware to allow users to test it before purchasing it.  (It is
  451.           shareware instead of commercial simply because I prefer the
  452.           shareware concept over the inflated prices that go with
  453.           commercial software to cover overhead that the user doesn't care
  454.           about anyway).  If you like ShapeShifter please send the
  455.           registration fee of $10.00 to the author.  For a measly $10.00
  456.           you will help support this software and help insure new shareware
  457.           products will be available from the author.  Your $10.00 entitles
  458.           you to use any version of ShapeShifter, and includes a way to
  459.           remove the beginning and ending delay screens.
  460.  
  461.           Using a Mouse
  462.  
  463.           ShapeShifter supports the use of a mouse.  If you have a mouse
  464.           driver enabled on your PC, ShapeShifter will automatically turn
  465.           on the cursor and be set for use of the mouse.  Note that due to
  466.           the nature of ShapeShifter, the main place a mouse can be used is
  467.           the configuration program (SSCFG).  The command line program SS
  468.           supports a mouse for the error message prompts only.
  469.  
  470.           Selecting menu items with a mouse
  471.           Using a mouse in ShapeShifter is pretty easily.  At menus simply
  472.           put the cursor on the item you wish to select and click any of
  473.           your mouse buttons.
  474.  
  475.           Selecting an input field with a mouse
  476.           On field input screens, you may use your mouse to select the
  477.           field to edit.  Simply put the cursor on the first character of
  478.           the input field you wish to modify, click, and the cursor will be
  479.           moved to that field ready for input.
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.           ShapeShifter - User's Guide                                     9
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.           Exiting an input screen with a mouse
  495.           After you are finished editing fields on an input screen, you may
  496.           use the mouse to specify whether to save or abort changes. 
  497.           Simply click the mouse on the portion of the bottom status line
  498.           that contains the text describing what you want to do.
  499.  
  500.           Using a mouse on dialog boxes
  501.           ShapeShifter displays prompts and error messages using a dialog
  502.           box.  With a mouse, simply click on the box containing the answer
  503.           you want to give.
  504.  
  505.  
  506.           Starting ShapeShifter
  507.  
  508.           When you call ShapeShifter you specify what it should do using
  509.           parameters on the command line (default settings as well as a few
  510.           options that can't be specified on the command line are
  511.           configured using SSCFG.EXE).  With ShapeShifter you are not
  512.           restricted to using different types of parameters in a predefined
  513.           order; ShapeShifter can handle parameters in any order you
  514.           specify them.  The types of parameters that ShapeShifter accepts
  515.           are:
  516.  
  517.                o    On/Off Options
  518.  
  519.                o    Other Options
  520.  
  521.                o    File names
  522.  
  523.           Options configure the way ShapeShifter operates.  Any parameter
  524.           that starts with a '-' or '/' is considered to be an option. 
  525.           There are two categories of options that you should be aware of. 
  526.           The first type of option can only have an on or off value.  These
  527.           options are specified with the following format:
  528.  
  529.                /option[+-]
  530.  
  531.           Note that the trailing + or - sign is optional, and if present
  532.           specifies how the option should be set (+ = ON, - = OFF).  If you
  533.           don't specify a trailing sign the option defaults to ON.
  534.  
  535.           The second type of option is one that can have a value other than
  536.           on or off.  The format for this type of option is:
  537.  
  538.                /option=XXXXX
  539.  
  540.           Note that the equal sign followed by the value to set the option
  541.           is required.
  542.  
  543.  
  544.           10                                    ShapeShifter - Introduction
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.           File names specify the file(s) that ShapeShifter should operate
  553.           on.  ShapeShifter allows you to specify as many filespecs as you
  554.           like - any of the specified file names can contain wildcards.
  555.  
  556.  
  557.           ShapeShifter Command Line Options
  558.  
  559.           There are quite a few options available that allow you to control
  560.           how ShapeShifter operates.  The following list shows the options
  561.           that can be used on the command line (see the option reference
  562.           for details on what each option does):
  563.  
  564.            /4       Sets the 43/50 line mode option.  (On/Off Option).
  565.  
  566.            /A=XXX   Sets the maximum age of files to process.  (You must specify
  567.                     a positive number in place of the XXX listed here).
  568.  
  569.            /C       Sets the option to create a list of converted files. 
  570.                     (On/Off Option).
  571.  
  572.            /D=X     Sets the date stamping method to use.  (You must specify one
  573.                     of the following letters in place of the X listed here:  L
  574.                     (Last file date), O (Original date), T (Today's date).
  575.  
  576.            /E=XXX   Sets the extension to convert to.  (A valid configured
  577.                     extension must be specified in place of the XXX listed
  578.                     here).
  579.  
  580.            /I       Sets the option telling ShapeShifter whether it should
  581.                     redirect output from the archivers/scanner.  (On/Off
  582.                     Option).
  583.  
  584.            /K       Sets the option telling ShapeShifter whether it should keep
  585.                     the original files that are converted.  (On/Off Option).
  586.  
  587.            /L=X     Sets the activity logging level (You must specify a number
  588.                     from 0 to 5 in place of the X listed here).
  589.  
  590.            /M       Sets option of mechanical (unattended mode) operation. 
  591.                     (On/Off Option).
  592.  
  593.            /N       Sets the option to support conversion of archives that
  594.                     contain nested archives.  (On/Off Option).
  595.  
  596.            /O       Sets the option to tell ShapeShifter whether it should redo
  597.                     options that are already in the target format.  (On/Off
  598.                     Option).
  599.  
  600.  
  601.  
  602.           ShapeShifter - User's Guide                                    11
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.            /P       Sets option to protect files created with PKZIP's -AV
  611.                     feature.  (On/Off Option).
  612.  
  613.            /R       Sets the option for recursion of directories when looking
  614.                     for matching files to convert.  (On/Off Option).
  615.  
  616.            /S       Option to tell ShapeShifter whether it should strip
  617.                     Read/Hidden/System attributes from files contained in
  618.                     archives.  (On/Off Option).
  619.  
  620.            /T       Test mode only option.  (On/Off Option).
  621.  
  622.            /U       Sets the option specifying whether ShapeShifter should
  623.                     update the configured BBS directory.
  624.  
  625.            /V       Sets the option to use the configured virus scanner. 
  626.                     (On/Off Option).
  627.  
  628.            /X       Set support of XMS and EMS for use by Switch! (On/Off
  629.                     Option).
  630.  
  631.  
  632.           Specifying On/Off Options
  633.  
  634.           When ShapeShifter scans the command line it looks for options by
  635.           looking for a leading '-' or '/'.  Once a '-' or '/' is found
  636.           ShapeShifter considers the next block of text (until a white space
  637.           character is hit) to be options specified by the caller.  On the
  638.           command line you can turn options on and turn options off.  The syntax
  639.           for specifying an option is as follows:
  640.  
  641.                -option[-|+][option 2[-|+]][option n...]
  642.  
  643.           Immediately after each option an optional "sign" can be used to
  644.           specify whether you want to turn the flag on (+) or off (-).  If the
  645.           sign isn't specified the option is turned on.  To look at an example
  646.           let's say you want to use ShapeShifter to strip extended attributes,
  647.           use logging level 5, not redo archives already in the target type,
  648.           convert to LZH (LHA), and recurse directories.  The following lists
  649.           several different ways to specify these options (all examples do the
  650.           same thing):
  651.  
  652.                -s -l5 -o- -r -e=lzh
  653.  
  654.                -s+ -l5 -o- -r+ -e=lzh
  655.  
  656.                -so-r -l5 -e=lzh
  657.  
  658.  
  659.  
  660.           12                                    ShapeShifter - Introduction
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.           As you can see there is a great deal of flexibility in how you specify
  669.           options to ShapeShifter.  Choose the method that you feel most
  670.           comfortable with.
  671.  
  672.           In the following Chapter each of the options supported by ShapeShifter
  673.           will be explained in detail.
  674.  
  675.  
  676.  
  677.           ShapeShifter Option Descriptions
  678.  
  679.           The remainder of this chapter will be dedicated to a description
  680.           of all options supported by ShapeShifter.  The configuration
  681.           program SSCFG.EXE should be used to set the default values of
  682.           each option to what you prefer.  Command line options allow you
  683.           to override the defaults you configure as well.
  684.  
  685.           In this chapter each option will be presented in alphabetical
  686.           order using the following format:
  687.  
  688.                Screen title (fieldname as displayed by SSCFG).
  689.  
  690.                Command line specifier for this option (if available)
  691.  
  692.                Screen this option is on in SSCFG.
  693.  
  694.                Synopsis (Description of this option)
  695.  
  696.                Notes (any special limitations or notes about this option).
  697.  
  698.           Okay, enough with the introductions, I'll move on to the option
  699.           descriptions.
  700.  
  701.           -------------------------------------------------------------
  702.           Archiver Name
  703.  
  704.           Command Line Specifier
  705.  
  706.                ** Not Available **
  707.  
  708.           SSCFG Screen This Option is On
  709.  
  710.                Archiver Options
  711.  
  712.           Synopsis
  713.  
  714.  
  715.  
  716.  
  717.  
  718.           ShapeShifter - User's Guide                                    13
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.           This option specifies the name of the archiver associated with a
  728.           specific extension (see the 'Extension' option).  The name you
  729.           specify is used to display what archive type is being converted
  730.           to.
  731.           -------------------------------------------------------------
  732.           Author Verification
  733.  
  734.           Command Line Specifier
  735.  
  736.                ** Not Available **
  737.  
  738.           SSCFG Screen This Option is On
  739.  
  740.                Archiver Options
  741.  
  742.           Synopsis
  743.  
  744.           This option specifies whether the archiver supports author
  745.           verified files.
  746.  
  747.           Notes
  748.  
  749.           ShapeShifter currently only supports PKZIP -AV files.  Other
  750.           author verification such as ARJ's security envelopes are not
  751.           supported.  (This decision mirrors the fact that PKZIPs -AV
  752.           feature is currently the only one in wide use for BBS files).
  753.  
  754.           If you have ShapeShifter configured to leave author verified
  755.           files alone (see the 'Preserve Author Verified files" option) it
  756.           will check for -AV files when converting from an archiver type
  757.           that has the Author Verification option set to 'Yes' (On).
  758.  
  759.           WARNING:  ShapeShifter does not use an external command or
  760.           archiver to determine if a file has -AV.  Instead, it looks
  761.           direct into the file expecting it to be in ZIP format.
  762.           -------------------------------------------------------------
  763.           Bad files directory
  764.  
  765.           Command Line Specifier
  766.  
  767.                ** Not available **
  768.  
  769.           SSCFG Screen This Option is On
  770.  
  771.                Misc Options
  772.  
  773.  
  774.  
  775.  
  776.           14                                     ShapeShifter - Option Reference
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.           Synopsis
  785.  
  786.           This option specifies a directory for ShapeShifter to move files
  787.           that it can't successfully convert.  If you specify a value here,
  788.           ShapeShifter will move all archives it encounters an error on
  789.           when converting.  (If the directory name you specify doesn't
  790.           exist, ShapeShifter will create it).
  791.  
  792.           Notes
  793.  
  794.           ShapeShifter considers a file bad if *any* error prevents it from
  795.           being properly converted.  Errors that keep a file from being
  796.           properly converted include disk errors as well as corrupt
  797.           archives.  For a complete list of circumstances that cause
  798.           ShapeShifter to consider the archive to be bad see the appendix
  799.           'How ShapeShifter Detects Corrupt Archives'.
  800.           -------------------------------------------------------------
  801.           Command to Execute After All Conversions Are Complete
  802.  
  803.           Command Line Specifier
  804.  
  805.                ** Not Available **
  806.  
  807.           SSCFG Screen This Option is On
  808.  
  809.                External Command Options
  810.  
  811.           Synopsis
  812.  
  813.           This option specifies the command line that ShapeShifter will
  814.           execute after all file conversions are done.
  815.  
  816.           Notes
  817.  
  818.           This option provides a way for you to do any special cleanup
  819.           desired.
  820.  
  821.           Note that the standard fields available for command lines from
  822.           ShapeShifter don't have meaning for this command line.
  823.  
  824.           See the appendix 'Specifying Command Lines' for details on how to
  825.           specify a command line to ShapeShifter.
  826.           -------------------------------------------------------------
  827.           Command to execute after creating an archive with this archiver
  828.  
  829.           Command Line Specifier
  830.  
  831.                ** Not Available **
  832.  
  833.  
  834.           ShapeShifter - User's Guide                                    15
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.           SSCFG This Option is On
  843.  
  844.                Archiver Options
  845.  
  846.           Synopsis
  847.  
  848.           This option specifies a command line that ShapeShifter will
  849.           execute after each new archive of this type is created.
  850.  
  851.           Notes
  852.  
  853.           If the command returns control with a non-zero error level set,
  854.           ShapeShifter will consider the archive corrupt and restore the
  855.           original file.
  856.  
  857.           See the appendix 'Specifying Command Lines' for details on how to
  858.           specify a command line to ShapeShifter.
  859.           -------------------------------------------------------------
  860.           Command to execute before beginning the conversion session
  861.  
  862.           Command Line Specifier
  863.  
  864.                ** Not Available **
  865.  
  866.           SSCFG Screen This Option is On
  867.  
  868.                External Command Options
  869.  
  870.           Synopsis
  871.  
  872.           This option specifies a DOS command line that ShapeShifter should
  873.           execute before it converts the first file.
  874.  
  875.           Notes
  876.  
  877.           This provides you a way to do preliminary setup before
  878.           ShapeShifter starts it's operation.  Note that if the program you
  879.           specify returns an error level, ShapeShifter will consider it a
  880.           signal to abort the conversion.
  881.  
  882.           See the appendix 'Specifying Command Lines' for details on how to
  883.           specify a command line to ShapeShifter.
  884.  
  885.           Note that the standard fields available for command lines from
  886.           ShapeShifter don't have meaning for this command.
  887.           -------------------------------------------------------------
  888.  
  889.  
  890.  
  891.  
  892.           16                                     ShapeShifter - Option Reference
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.           Command to execute before creating an archive with this archiver
  901.  
  902.           Command Line Specifier
  903.  
  904.                ** Not Available **
  905.  
  906.           SSCFG Screen This Option is On
  907.  
  908.                Archiver Options
  909.  
  910.           Synopsis
  911.  
  912.           This option specifies a command line that ShapeShifter will
  913.           execute before *each* archive of this type is created.  (See the
  914.           section 'Command Lines' for details on specifying command lines
  915.           to ShapeShifter).
  916.  
  917.           Notes
  918.  
  919.           If the command returns control with an error level set,
  920.           ShapeShifter will consider the archive to be corrupt and will
  921.           abort the conversion of the file.
  922.  
  923.           See the appendix 'Specifying Command Lines' for details on how to
  924.           specify a command line to ShapeShifter.
  925.  
  926.           -------------------------------------------------------------
  927.           Command to execute before extracting an archive with this
  928.           archiver
  929.  
  930.           Command Line Specifier
  931.  
  932.                ** Not Available **
  933.  
  934.           SSCFG Screen This Option is On
  935.  
  936.                Archiver Options
  937.  
  938.           Synopsis
  939.  
  940.           This option specifies a command line that should be executed
  941.           before *each* archive of the current type is extracted.
  942.  
  943.           Notes
  944.  
  945.           If the command that is executed returns control with an error
  946.           level set, the current archive will be considered corrupt and
  947.           won't be converted.
  948.  
  949.  
  950.           ShapeShifter - User's Guide                                    17
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.           See the appendix 'Specifying Command Lines' for details on how to
  959.           specify a command line to ShapeShifter.
  960.           -------------------------------------------------------------
  961.           Convert archives containing subdirs
  962.  
  963.           Command Line Specifier
  964.  
  965.                ** Not available **
  966.  
  967.           SSCFG Screen This Option is On
  968.  
  969.                Misc options
  970.  
  971.           Synopsis
  972.  
  973.           This option specifies whether ShapeShifter should convert
  974.           archives that contain subdirectories.  When you set this option
  975.           to 'Yes' (On), ShapeShifter will convert archives that contain
  976.           subdirectories (if the archiver used to extract the file *and*
  977.           the archiver used to create the new file support subdirs).  When
  978.           you set this option to 'No' (Off), ShapeShifter will not convert
  979.           files with subdirectories - even if the archivers do support
  980.           dirs.
  981.           -------------------------------------------------------------
  982.           Convert to  (Extension to convert files to)
  983.  
  984.           Command Line Specifier
  985.  
  986.                /E=XXX
  987.  
  988.           SSCFG Screen This Option is On
  989.  
  990.                Misc Options
  991.  
  992.           Synopsis
  993.  
  994.           This option specifies the file extension to convert archives to. 
  995.           The extension you specify must be an extension that is configured
  996.           as an archive extension using SSCFG.
  997.           -------------------------------------------------------------
  998.           Create Command      (Command to execute to create an archive)
  999.  
  1000.           Command Line Specifiers
  1001.  
  1002.                ** Not Available **
  1003.  
  1004.           SSCFG Screen This Option is On
  1005.  
  1006.                Archiver Options
  1007.  
  1008.           18                                     ShapeShifter - Option Reference
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.           Synopsis
  1017.  
  1018.           This option specifies the command line required to create an
  1019.           archive with the specified archiver.
  1020.  
  1021.           See the appendix 'Specifying Command Lines' for details on how to
  1022.           specify a command line to ShapeShifter.
  1023.           -------------------------------------------------------------
  1024.           Create list of files converted
  1025.  
  1026.           Command Line Specifiers
  1027.  
  1028.                /C
  1029.  
  1030.           SSCFG Screen This Option is On
  1031.  
  1032.                Misc Options
  1033.  
  1034.           Synopsis
  1035.  
  1036.           This option specifies whether ShapeShifter should create a list
  1037.           of the files that are converted.  If this option is set to 'Yes'
  1038.           (On), ShapeShifter creates a list of files converted in the file
  1039.           specified by the 'Save Converted List in' option.
  1040.           -------------------------------------------------------------
  1041.           Date Stamping Method
  1042.  
  1043.           Command Line Specifier
  1044.  
  1045.                /D=X      (Where X is replaced by one of the options listed
  1046.                          below)
  1047.  
  1048.           SSCFG Screen This Option is On
  1049.  
  1050.                Misc Options
  1051.  
  1052.           Synopsis
  1053.  
  1054.           This option determines what file date stamping option
  1055.           ShapeShifter is going to use.  The date stamping method may be
  1056.           one of the following:
  1057.  
  1058.                Date Stamping Method          What it means
  1059.                --------------------          -------------
  1060.                0 or O                        Original date - converted
  1061.                                              files will have the same file
  1062.                                              date after the conversion as
  1063.                                              they did before ShapeShifter
  1064.                                              saw them.
  1065.  
  1066.           ShapeShifter - User's Guide                                    19
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.                1 or T                        Today's date - converted files
  1075.                                              will be time stamped with the
  1076.                                              date and time they were
  1077.                                              converted.
  1078.  
  1079.                2 or L                        Last files date - converted
  1080.                                              files will be time stamped
  1081.                                              with the date and time of the
  1082.                                              latest file found within them.
  1083.           -------------------------------------------------------------
  1084.           Dir File(s)
  1085.  
  1086.           Command Line Specifier
  1087.  
  1088.                ** Not Available **
  1089.  
  1090.           SSCFG Screen This Option is On
  1091.  
  1092.                Misc Options
  1093.  
  1094.           Synopsis
  1095.  
  1096.           This option specifies the BBS dir file(s) to update (update only
  1097.           occurs if you have the 'Update BBS/Dir file with new extension
  1098.           and size' option set to 'Yes').
  1099.  
  1100.           You may specify multiple filespecs in this field (separated by a
  1101.           space), and any of the filespecs may contain wildcards.
  1102.  
  1103.           Notes
  1104.  
  1105.           When you have ShapeShifter configured to update a BBS file
  1106.           listing, *all* files matching the specs you specify in this field
  1107.           will be searched for files matching those that were converted. 
  1108.           For faster operation you should not specify filespecs that will
  1109.           cause excessive files to be searched.
  1110.           -------------------------------------------------------------
  1111.           Dir Type
  1112.  
  1113.           Command Line Specifier
  1114.  
  1115.                ** Not Available **
  1116.  
  1117.           SSCFG Screen This Option is On
  1118.  
  1119.                Misc Options
  1120.  
  1121.           Synopsis
  1122.  
  1123.  
  1124.           20                                     ShapeShifter - Option Reference
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.           This option specifies the type of BBS directory file that
  1133.           ShapeShifter should update.  (You must set the 'Update BBS/Dir
  1134.           file with new Extension and Size' option to 'Yes' to tell
  1135.           ShapeShifter to update the file).
  1136.  
  1137.           The following dir types are currently supported by ShapeShifter:
  1138.  
  1139.                Auntie (v 511 format)
  1140.                PC Board (v14.5 format)
  1141.                ProDoor
  1142.                Quick BBS
  1143.                TBBS
  1144.                User Defined
  1145.  
  1146.           Notes
  1147.  
  1148.           The support for defined BBS types is current as of the release of
  1149.           this software.  In order to provide support for future versions
  1150.           with a different format, or for a type not listed above, you may
  1151.           use the user defined type to tell ShapeShifter about the DIR file
  1152.           format.
  1153.  
  1154.           It should be noted that ShapeShifter can't support every possible
  1155.           file format.  To be able to update a BBS dir file, ShapeShifter
  1156.           has three requirements:
  1157.  
  1158.                The column that filenames start in must be reserved for the
  1159.                filename and not overlaid with other data on any line.  If
  1160.                data other than the filename can lie in the starting
  1161.                filename column, ShapeShifter may incorrectly think it found
  1162.                a file when it didn't.
  1163.  
  1164.                A file size field must be present, and it must reside on the
  1165.                same line as the filename.  In addition, it must be non-
  1166.                zero.
  1167.  
  1168.                The filename and size must each start in a fixed column.
  1169.  
  1170.           To update a user defined BBS file listing type, you must specify
  1171.           the file and size starting column information.  See the following
  1172.           options to specify the layout of a user defined file listing:
  1173.  
  1174.                File Start, Len
  1175.                Size Start, Len
  1176.           and  R. Just
  1177.           -------------------------------------------------------------
  1178.  
  1179.  
  1180.  
  1181.  
  1182.           ShapeShifter - User's Guide                                    21
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.           Extension  (Archive Extension)
  1191.  
  1192.           Command Line Specifier
  1193.  
  1194.                ** Not Available **
  1195.  
  1196.           SSCFG Screen This Option is On
  1197.  
  1198.                Archiver Options
  1199.  
  1200.           Synopsis
  1201.  
  1202.           This option specifies the extension used by a given archiver (if
  1203.           you're looking for the extension to convert to, see the 'Convert
  1204.           To' option).
  1205.  
  1206.           The extension you specify is used by ShapeShifter to identify
  1207.           files created by this archiver.
  1208.           -------------------------------------------------------------
  1209.           Extract Command     (Command to extract files from an archive)
  1210.  
  1211.           Command Line Specifier
  1212.  
  1213.                ** Not Available **
  1214.  
  1215.           SSCFG Screen This Option is On
  1216.  
  1217.                Archiver Options
  1218.  
  1219.           Synopsis
  1220.  
  1221.           This option specifiers the command line required to extract files
  1222.           using the specified archiver.
  1223.  
  1224.           See the appendix 'Specifying Command Lines' for details on how to
  1225.           specify a command line to ShapeShifter.
  1226.           -------------------------------------------------------------
  1227.           File Attributes     (Does the archiver support file attributes)
  1228.  
  1229.           Command Line Specifier
  1230.  
  1231.                ** Not Available **
  1232.  
  1233.           SSCFG Screen This Option is On
  1234.  
  1235.                Archiver Options
  1236.  
  1237.  
  1238.  
  1239.  
  1240.           22                                     ShapeShifter - Option Reference
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.           Synopsis
  1249.  
  1250.           This option specifies whether the current archiver supports
  1251.           Hidden/System/Read only attributes.
  1252.  
  1253.           Notes
  1254.  
  1255.           If you have ShapeShifter configured to strip attributes (see the
  1256.           'Strip attributes' option), this option is ignored.
  1257.           -------------------------------------------------------------
  1258.           File Start,Len
  1259.  
  1260.           Command Line Specifier
  1261.  
  1262.                ** Not Available **
  1263.  
  1264.           SSCFG Screen This Option is On
  1265.  
  1266.                Misc Options
  1267.  
  1268.           Synopsis
  1269.  
  1270.           This option specifies the starting column and length of the
  1271.           filename field in the BBS file listing.  The value you specify
  1272.           here is only used when you set the 'Dir Type' option to user
  1273.           defined.
  1274.           -------------------------------------------------------------
  1275.           Keep original archive  (Keep the original archive in addition to
  1276.           the newly converted version)
  1277.  
  1278.           Command Line Specifier
  1279.  
  1280.                /K[+-]
  1281.  
  1282.           SSCFG Screen This Option is On
  1283.  
  1284.                Misc Options
  1285.  
  1286.           Synopsis
  1287.  
  1288.           This option specifies whether or not ShapeShifter should keep the
  1289.           original archive file after conversion.  If you set this option
  1290.           to 'Yes' (On) both the original archive and the newly created
  1291.           archive will be kept on the disk.  You should set this option to
  1292.           'No' (Off) to cause the original archive to be removed after
  1293.           being successfully converted.  
  1294.  
  1295.           Notes
  1296.  
  1297.  
  1298.           ShapeShifter - User's Guide                                    23
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.           It isn't possible for ShapeShifter to honor the redo archives
  1307.           option when this option is set (since redoing an archive implies
  1308.           you will modify the original).  When this option is set it
  1309.           automatically overrides the Redo option.
  1310.           -------------------------------------------------------------
  1311.           Log File
  1312.  
  1313.           Command Line Specifier
  1314.  
  1315.                ** Not Available **
  1316.  
  1317.           SSCFG Screen This Option is On
  1318.  
  1319.                Misc Options
  1320.  
  1321.           Synopsis
  1322.  
  1323.           This option specifies the file name (or logical device) that
  1324.           ShapeShifter should log information about files converted to.
  1325.  
  1326.           Notes
  1327.  
  1328.           The logging level option must be set to non-zero for activity
  1329.           logging to occur.
  1330.  
  1331.           The file you specify may be a logical DOS device if desired.  For
  1332.           instance, PRN causes output to go to the printer attached to your
  1333.           computer on LPT1.
  1334.  
  1335.           If the file you specify already exists, ShapeShifter will append
  1336.           the logging information to the end of the file.
  1337.           -------------------------------------------------------------
  1338.           Logging Level
  1339.  
  1340.           Command Line Specifier
  1341.  
  1342.                /L=X      (Where X is replaced by a number from 0 to 5)
  1343.  
  1344.           SSCFG Screen This Option is On
  1345.  
  1346.                Misc Options
  1347.  
  1348.           Synopsis
  1349.  
  1350.           This option specifies the activity logging level for ShapeShifter
  1351.           to use.  When set to a non-zero value and a log file is specified
  1352.           (see the 'Log File' option), ShapeShifter will log activity as it
  1353.           converts files.  The following table shows the various log level
  1354.           values and what they do:
  1355.  
  1356.           24                                     ShapeShifter - Option Reference
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.                Level     Result
  1365.                -----     ------
  1366.                  0       No activity logging is performed
  1367.  
  1368.                  1       Lists file names converted in addition to errors
  1369.                          encountered.
  1370.  
  1371.                  2       File sizes (before and after are added to data
  1372.                          logged from lower levels)
  1373.  
  1374.                  3       Internal (nested) archive names that were
  1375.                          converted are added to the data from lower logging
  1376.                          levels.
  1377.  
  1378.                  4       Totals by subdirectory are added to the data from
  1379.                          lower log levels.
  1380.  
  1381.                  5       Adds overall totals to the other log levels.
  1382.           -------------------------------------------------------------
  1383.           Max age of files to convert
  1384.  
  1385.           Command Line Specifier
  1386.  
  1387.                /A=X      (Where X is replaced by the number of days)
  1388.  
  1389.           SSCFG Screen This Option is On
  1390.  
  1391.                Misc Options
  1392.  
  1393.           Synopsis
  1394.  
  1395.           This option sets the maximum age of files to be converted.  If
  1396.           you set this option to a non-zero value, only files that are
  1397.           newer than the conversion date minus the maximum age will be
  1398.           converted.  The following examples show how this option works:
  1399.  
  1400.                Max Age Setting          What ShapeShifter Does
  1401.                ---------------          ----------------------
  1402.                     0                   Converts all archives that match
  1403.                                         the specified filespecs -
  1404.                                         regardless of age.
  1405.  
  1406.                     1                   Only converts archives that match
  1407.                                         the specified filespecs and have a
  1408.                                         file date of yesterday or later.
  1409.  
  1410.                     2                   Only converts archives that match
  1411.                                         the specified filespecs and have a
  1412.                                         file date no more than 2 days old.
  1413.  
  1414.           ShapeShifter - User's Guide                                    25
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.           -------------------------------------------------------------
  1423.           Memory to make available  (Amount of memory to free for archiver)
  1424.  
  1425.           Command Line Specifier
  1426.  
  1427.                ** Not Available **
  1428.  
  1429.           SSCFG Screen This Option is On
  1430.  
  1431.                Archiver Options
  1432.  
  1433.           Synopsis
  1434.  
  1435.           This option specifies the amount of memory to make available for
  1436.           the archiver when Switch! is used (see the 'Use Switch!' option). 
  1437.  
  1438.           Notes
  1439.  
  1440.           A value of 640 as well as 0 causes the maximum amount of memory
  1441.           to be freed for running the current archiver.
  1442.           -------------------------------------------------------------
  1443.           Preserve Author Verified files
  1444.  
  1445.           Command Line Specifier
  1446.  
  1447.                /L
  1448.  
  1449.           SSCFG Screen This Option is On
  1450.  
  1451.                Misc Options
  1452.  
  1453.           Synopsis
  1454.  
  1455.           This option specifies whether ShapeShifter should leave -AV files
  1456.           (created by PKZIP) alone when it converts files.
  1457.           -------------------------------------------------------------
  1458.           R. Just  (Is the file size field right justified)
  1459.  
  1460.           Command Line Specifier
  1461.  
  1462.                ** Not Available **
  1463.  
  1464.           SSCFG Screen This Option is On
  1465.  
  1466.                Misc Options
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.           26                                     ShapeShifter - Option Reference
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.           Synopsis
  1481.  
  1482.           This option specifies whether or not the file size field is right
  1483.           justified when you use a user defined dir type.  (See the 'Dir
  1484.           Type' option).
  1485.           -------------------------------------------------------------
  1486.           Recurse Archives  (Convert archives that are nested inside other
  1487.           archives)
  1488.  
  1489.           Command Line Specifier
  1490.  
  1491.                /N
  1492.  
  1493.           SSCFG Screen This Option is On
  1494.  
  1495.                Misc Options
  1496.  
  1497.           Synopsis
  1498.  
  1499.           This option specifies whether archives inside files that are
  1500.           converted should also be converted.  If this option is set to
  1501.           'No' (Off), any archives inside a file being converted will be
  1502.           untouched.  If this option is set to 'Yes' (On), archives within
  1503.           files being converted will also be converted.  ShapeShifter can
  1504.           properly handle nested archives to virtually any level.
  1505.  
  1506.           Notes
  1507.  
  1508.           If you set this option to 'No', ShapeShifter will still
  1509.           successfully convert (if no other errors occur) archives that
  1510.           contain nested archives.  Be aware that archives within converted
  1511.           files will be left in their original format unless you turn this
  1512.           option on though.
  1513.           -------------------------------------------------------------
  1514.           Recurse Subdirs  (Recurse subdirectories looking for matching
  1515.           files to convert)
  1516.  
  1517.           Command Line Specifier
  1518.  
  1519.                /R
  1520.  
  1521.           SSCFG Screen This Option is On
  1522.  
  1523.                Misc Options
  1524.  
  1525.           Synopsis
  1526.  
  1527.           This option specifies whether ShapeShifter should search
  1528.           subdirectories for the specified files as it looks for files to
  1529.  
  1530.           ShapeShifter - User's Guide                                    27
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.           convert.  If you set this option to 'Yes' (On), ShapeShifter
  1539.           searches the child directories of each file specification looking
  1540.           for matching files.  If you set this option to 'No' (Off),
  1541.           ShapeShifter will only look in the directories specified for
  1542.           filespecs.
  1543.  
  1544.           Notes
  1545.  
  1546.           The file specifications you use with ShapeShifter are honored
  1547.           even when this option is set.  Consider the following examples:
  1548.  
  1549.                File Spec           What ShapeShifter does with Recurse On
  1550.                ---------           --------------------------------------
  1551.                *.ZIP               Searches the current directory as well
  1552.                                    as child directories for .ZIP files to
  1553.                                    convert.
  1554.  
  1555.                \*.*                Searches the entire current drive for
  1556.                                    files of any of the configured archive
  1557.                                    types to convert.
  1558.           -------------------------------------------------------------
  1559.           Redirect I/O  (Redirect I/O from the virus scanners and
  1560.           archivers)
  1561.  
  1562.           Command Line Specifier
  1563.  
  1564.                /I
  1565.  
  1566.           SSCFG Screen This Option Is On
  1567.  
  1568.                Misc Options
  1569.  
  1570.           Synopsis
  1571.  
  1572.           This option controls whether or not ShapeShifter attempts to
  1573.           redirect the output from archivers and the virus scanner.
  1574.  
  1575.           Note
  1576.  
  1577.           ShapeShifter's output redirection requires output to be DOS
  1578.           redirectable.   (Note, ShapeShifter *can* successfully redirect
  1579.           output from LHA and similar programs!).
  1580.  
  1581.           Although ShapeShifter can redirect output, it isn't really
  1582.           necessary.  ShapeShifter can cause all but direct screen writes
  1583.           to be within it's defined window area.
  1584.           ------------------------------------------------------------
  1585.  
  1586.  
  1587.  
  1588.           28                                     ShapeShifter - Option Reference
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.           Redo archives that are already the target type
  1597.  
  1598.           Command Line Specifier
  1599.  
  1600.                /O
  1601.  
  1602.           SSCFG Screen This Option is On
  1603.  
  1604.                Misc Options
  1605.  
  1606.           Synopsis
  1607.  
  1608.           This option controls whether or not ShapeShifter will recreate
  1609.           archives that are already in the target format.
  1610.  
  1611.           Notes
  1612.  
  1613.           Recreation of archives already in the target format is a handy
  1614.           way to remove BBS ad comments in addition to allowing you to
  1615.           insure the maximum compression of the archiver was used.
  1616.           -------------------------------------------------------------
  1617.           Save Converted List in
  1618.  
  1619.           Command Line Specifier
  1620.  
  1621.                ** Not Available **
  1622.  
  1623.           SSCFG Screen This Option is On
  1624.  
  1625.                Misc Options
  1626.  
  1627.           Synopsis
  1628.  
  1629.           This option specifies the filename (or logical device) for
  1630.           ShapeShifter to save the list of filenames that were converted. 
  1631.  
  1632.           Notes
  1633.  
  1634.           You may specify a filename or a DOS device for output of the
  1635.           converted files list.  For example, PRN causes output to go to
  1636.           the device attached to LPT1.
  1637.  
  1638.           If you specify the name of a file that already exists,
  1639.           ShapeShifter will append the converted file names to the end of
  1640.           the file.
  1641.           -------------------------------------------------------------
  1642.           Scanner Command
  1643.  
  1644.  
  1645.  
  1646.           ShapeShifter - User's Guide                                    29
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.           Command Line Specifier
  1655.  
  1656.                ** Not Available **
  1657.  
  1658.           SSCFG Screen This Option is On
  1659.  
  1660.                Misc Options
  1661.  
  1662.           Synopsis
  1663.  
  1664.           This option allows you to specify the DOS command line for the
  1665.           virus scanner of your choice.
  1666.  
  1667.           Notes
  1668.  
  1669.           See the appendix 'Specifying Command Lines' for information on
  1670.           special features available in ShapeShifter for command line
  1671.           specification.
  1672.  
  1673.           ShapeShifter requires a virus scanner that sets the DOS error
  1674.           level if a virus is detected (if you desire to use a virus
  1675.           scanner).  The scanner should use an exit code (errorlevel) of 0
  1676.           if there were no viral infections detected.  A non-zero exit code
  1677.           is interpreted by ShapeShifter as saying one or more of the files
  1678.           are infected.
  1679.           -------------------------------------------------------------
  1680.           Scanner supports subdirs
  1681.  
  1682.           Command Line Specifier
  1683.  
  1684.                ** Not Available **
  1685.  
  1686.           SSCFG Screen This Option is On
  1687.  
  1688.                Misc Options
  1689.  
  1690.           Synopsis
  1691.  
  1692.           This option specifies whether or not the virus scanner you're
  1693.           using supports automatic searching of child directories.
  1694.  
  1695.           Notes
  1696.  
  1697.           ShapeShifter doesn't require a scanner that supports subdirs.  If
  1698.           you set this option to 'No' (Off), ShapeShifter will call the
  1699.           scanner to look at files in each directory as required.  Setting
  1700.           this option to 'Yes' (On) may be faster for virus scanners that
  1701.           support dirs.
  1702.           -------------------------------------------------------------
  1703.  
  1704.           30                                     ShapeShifter - Option Reference
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.           Size Start,Len
  1713.  
  1714.           Command Line Specifier
  1715.  
  1716.                ** Not Available **
  1717.  
  1718.           SSCFG Screen This Option is On
  1719.  
  1720.                Misc Options
  1721.  
  1722.           Synopsis
  1723.  
  1724.           This option sets the starting column and length of the file size
  1725.           field in a user defined BBS listing.  ShapeShifter will only use
  1726.           the values you specify here if you set the 'Dir Type' option to
  1727.           user defined.
  1728.  
  1729.           Take a look at the 'R. Just' option to specify whether or not the
  1730.           file size field is right justified.
  1731.           -------------------------------------------------------------
  1732.           Strip attributes (HSR)
  1733.  
  1734.           Command Line Specifier
  1735.  
  1736.                /S
  1737.  
  1738.           SSCFG Screen This Option is On
  1739.  
  1740.                Misc Options
  1741.  
  1742.           Synopsis
  1743.  
  1744.           This option allows you to tell ShapeShifter to remove Hidden,
  1745.           System, and Read Only attributes found on files that are inside
  1746.           archives being converted.
  1747.  
  1748.           If you set this option to 'Yes' (On), ShapeShifter will remove
  1749.           all hidden/system/read only file attributes.
  1750.  
  1751.           Notes
  1752.  
  1753.           If the archiver you're converting to doesn't support file
  1754.           attributes and this option is off, ShapeShifter will report an
  1755.           error on attempts to convert any archive that contains files with
  1756.           one of the attributes set.  If on the otherhand you turn this
  1757.           option on, ShapeShifter will remove the file attributes thus
  1758.           allowing the archiver to handle the files.
  1759.           -------------------------------------------------------------
  1760.  
  1761.  
  1762.           ShapeShifter - User's Guide                                    31
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.           SubDirs        (Does the archiver support subdirs)
  1771.  
  1772.           Command Line Specifier
  1773.  
  1774.                ** Not Available **
  1775.  
  1776.           SSCFG Screen This Option is On
  1777.  
  1778.                Archiver Options
  1779.  
  1780.           Synopsis
  1781.  
  1782.           This option specifies whether the current archiver supports
  1783.           subdirectories within archives.
  1784.  
  1785.           Notes
  1786.  
  1787.           If you have ShapeShifter configured to support subdirs (see the
  1788.           'Convert archives containing subdirs' option) and this option is
  1789.           set to 'No' (Off), ShapeShifter will not allow conversion of
  1790.           archives with subdirs when converting to this type of archive. 
  1791.           Note that if ShapeShifter isn't configured to support conversion
  1792.           of archives with subdirs, this option is ignored.
  1793.           -------------------------------------------------------------
  1794.           Switch! to EMS
  1795.  
  1796.           Command Line Specifier
  1797.  
  1798.                /X   (Note:  This command line specifier also enables use of
  1799.                     XMS as a first choice)
  1800.  
  1801.           SSCFG Screen This Option is On
  1802.  
  1803.                Misc Options
  1804.  
  1805.           Synopsis
  1806.  
  1807.           This option controls whether or not ShapeShifter uses EMS when
  1808.           Switch!ing memory.
  1809.  
  1810.           Notes
  1811.  
  1812.           Switch! is only used if you configure it to be used for a given
  1813.           archiver.  (See the 'Use Switch' option description).
  1814.           -------------------------------------------------------------
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.           32                                     ShapeShifter - Option Reference
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.           Switch! to XMS
  1829.  
  1830.           Command Line Specifier
  1831.  
  1832.                /X   (Note:  This command line specifier also enables use of
  1833.                     EMS as a second choice)
  1834.  
  1835.           SSCFG Screen This Option is On
  1836.  
  1837.                Misc Options
  1838.  
  1839.           Synopsis
  1840.  
  1841.           This option controls whether or not ShapeShifter uses XMS when
  1842.           Switch!ing memory.
  1843.  
  1844.           Notes
  1845.  
  1846.           Switch! is only used if you configure it to be used for a given
  1847.           archiver.  (See the 'Use Switch' option description).
  1848.           -------------------------------------------------------------
  1849.           Test Only
  1850.  
  1851.           Command Line Specifier
  1852.  
  1853.                /T
  1854.  
  1855.           SSCFG Screen This Option is On
  1856.  
  1857.                Misc Options
  1858.  
  1859.           Synopsis
  1860.  
  1861.           When this option is set to 'Yes' (On), ShapeShifter will go
  1862.           through all the steps to convert the files you specify without
  1863.           actually creating or removing the old files.
  1864.           -------------------------------------------------------------
  1865.           Update BBS/Dir File With New Extension and Size
  1866.  
  1867.           Command Line Specifier
  1868.  
  1869.                /U
  1870.  
  1871.           SSCFG Screen This Option is On
  1872.  
  1873.                Misc Option
  1874.  
  1875.  
  1876.  
  1877.  
  1878.           ShapeShifter - User's Guide                                    33
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.           Synopsis
  1887.  
  1888.           This option specifies whether ShapeShifter should update a BBS
  1889.           type DIR file with the new file extensions and sizes.  If you set
  1890.           this option to 'Yes' (On), ShapeShifter will update the file(s)
  1891.           specified (see the 'Dir File(s)' option).
  1892.  
  1893.           Notes
  1894.  
  1895.           ShapeShifter uses several options to determine how to locate file
  1896.           names and sizes in the BBS directory for updating.  See the 'Dir
  1897.           Type' option description.
  1898.           -------------------------------------------------------------
  1899.           Use 43/50 Line Mode
  1900.  
  1901.           Command Line Specifier
  1902.  
  1903.                /4
  1904.  
  1905.           SSCFG Screen This Option is On
  1906.  
  1907.                Misc Options
  1908.  
  1909.           Synopsis
  1910.  
  1911.           This option specifies whether ShapeShifter should operate using
  1912.           43/50 line mode instead of the standard 25 lines.
  1913.  
  1914.           Notes
  1915.  
  1916.           This option is only available with an EGA, VGA, or equivalent.
  1917.           -------------------------------------------------------------
  1918.           Use Switch!
  1919.  
  1920.           Command Line Specifier
  1921.  
  1922.                ** Not Available **
  1923.  
  1924.           SSCFG Screen This Option is On
  1925.  
  1926.                Archiver Options
  1927.  
  1928.           Synopsis
  1929.  
  1930.           This option specifies whether ShapeShifter should use Switch! for
  1931.           the current archiver.  Switch! is a special function that allows
  1932.           ShapeShifter to free virtually all the memory it is using to make
  1933.           it available for running the archiver.
  1934.  
  1935.  
  1936.           34                                     ShapeShifter - Option Reference
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.           Notes
  1945.  
  1946.           This option is closely related to several other options:
  1947.  
  1948.                Memory to make available
  1949.  
  1950.                Switch! to EMS
  1951.  
  1952.                Switch! to XMS
  1953.           -------------------------------------------------------------
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.           ShapeShifter - User's Guide                                    35
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.           Use Virus Scanner
  2003.  
  2004.           Command Line Specifier
  2005.  
  2006.                /V
  2007.  
  2008.           SSCFG Screen This Option is On
  2009.  
  2010.                Misc Options
  2011.  
  2012.           Synopsis
  2013.  
  2014.           This option specifies whether ShapeShifter should use the
  2015.           configured virus scanner (see the 'Scanner Command' option).  If
  2016.           you set this option to 'Yes' (On), ShapeShifter will use the
  2017.           virus scanner you specified with SSCFG.
  2018.  
  2019.           Notes
  2020.  
  2021.           ShapeShifter requires a virus scanner that sets the DOS error
  2022.           level if a virus is detected (if you desire to use a virus
  2023.           scanner).  The scanner should use an exit code (errorlevel) of 0
  2024.           if there were no viral infections detected.  A non-zero exit code
  2025.           is interpreted by ShapeShifter as saying one or more of the files
  2026.           are infected.
  2027.           -------------------------------------------------------------
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.           36                                     ShapeShifter - Option Reference
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.                                                                  Appendices
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.           Appendix A - How ShapeShifter Detects Corrupt Archives.
  2075.  
  2076.           There are many circumstances that can keep an archive from being
  2077.           successfully converted.  The following is an alphabetic list by
  2078.           error message (as displayed on the ShapeShifter conversion
  2079.           screen) detailing all valid reasons for stoppage of a conversion,
  2080.           and whether the file will be considered corrupt by ShapeShifter
  2081.           (i.e. a corrupt file is moved to the configured bad files
  2082.           directory).  Note that ShapeShifter will *NOT* delete a file for
  2083.           being corrupt - this is a decision best left to the user!
  2084.  
  2085.                                                        Archive Moved
  2086.                Reason for failure                      To Bad Files Dir
  2087.                ------------------                      ----------------
  2088.                (-AV File)
  2089.                Author verification was detected in     *NO*
  2090.                the file and you have ShapeShifter
  2091.                configured to preserve author verified
  2092.                files.  (This is not considered as a 
  2093.                corrupt archive - it just keeps 
  2094.                ShapeShifter from modifying the file).
  2095.  
  2096.                (AttrAbort)
  2097.                File attributes are contained in the    Yes
  2098.                archive to be converted when the type
  2099.                of archive you're converting to isn't
  2100.                configured as supporting attributes 
  2101.                (and you don't have ShapeShifter set
  2102.                to strip attributes).
  2103.  
  2104.                (Corrupt)
  2105.                Archiver returns with an error level    Yes
  2106.                set when ShapeShifter attempts to 
  2107.                extract the contents of a file.
  2108.  
  2109.                (CreateErr)
  2110.                The archiver returned with an error     Yes
  2111.                level set when ShapeShifter attempted
  2112.                to create the new file.
  2113.  
  2114.                (CreateErr)
  2115.                The target file already exists.         Yes
  2116.  
  2117.                (CreateErr)
  2118.                The expected target file couldn't be    Yes
  2119.                found after the archive creation
  2120.                command was completed.
  2121.  
  2122.  
  2123.           38                                        ShapeShifter Appendices
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.                (DirAbort)
  2132.                Subdirectories were detected in the     Yes
  2133.                archive when the type of archive 
  2134.                you're converting to isn't configured
  2135.                as supporting dirs, or ShapeShifter is
  2136.                configured to not allow conversion of
  2137.                files containing subdirs.
  2138.  
  2139.                (EXEC Err)
  2140.                Failure to spawn the archiver, virus    Yes
  2141.                scanner, or a user command (i.e. not
  2142.                enough memory, command not found, etc)
  2143.  
  2144.                (INFECTED!)
  2145.                Virus Scanner returns with an error     Yes
  2146.                level set.
  2147.  
  2148.                (RedoAbort)
  2149.                When attempting to redo an archive      Yes
  2150.                that was already in the target format,
  2151.                ShapeShifter was unable to generate a 
  2152.                unique filename.  (It tries 1000
  2153.                different extensions when attempting to
  2154.                create a temp file for the conversion).
  2155.  
  2156.                (Skipped)
  2157.                Skipped file because it is already      *NO*
  2158.                in the target format and ShapeShifter
  2159.                isn't configured to redo archives 
  2160.                already in the target format.
  2161.  
  2162.                (SysError)
  2163.                Internal program error                  Yes
  2164.                (This occurs if a system or internal
  2165.                error in ShapeShifter occurs).
  2166.  
  2167.                (UserAbort)
  2168.                User configured program returns with    Yes
  2169.                an error level set.
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.           ShapeShifter - User's Guide                                    39
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.           Appendix B - Archivers, Scanners, and User Programs Supported by
  2190.           ShapeShifter
  2191.  
  2192.           ShapeShifter supports a wide variety of programs including user
  2193.           commands that allow you to customize operation for a variety of
  2194.           situations.  There is one *major* requirement for a program to
  2195.           work properly with ShapeShifter - use of the DOS error level
  2196.           (exit code).  ShapeShifter expects commands to return with the
  2197.           error level set if an error is detected (it doesn't matter what
  2198.           the error level is set to - as long as it's non-zero).  Likewise,
  2199.           ShapeShifter expects the error level to be cleared (set to zero)
  2200.           when an error doesn't occur.
  2201.  
  2202.           Any program that returns control to ShapeShifter with a non-zero
  2203.           errorlevel set can't be used.  On the other hand, if a program
  2204.           always returns control with the error level cleared, ShapeShifter
  2205.           will work with the program but will be crippled in that it can't
  2206.           detect when an archive is corrupt.
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.           40                                        ShapeShifter Appendices
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.           Appendix C - ShapeShifter Error Messages
  2248.  
  2249.           This appendix gives a list (alphabetical) of the common
  2250.           ShapeShifter error messages.  Each message is accompanied by a
  2251.           short description describing what the message means.
  2252.  
  2253.  
  2254.           Abort ShapeShifter?
  2255.                This message is displayed when the ESCape key is pressed
  2256.                during a conversion session. 
  2257.  
  2258.           Aborted: Archive creation error
  2259.                This message occurs when the archiver fails to create the
  2260.                archive as expected.  Note that this message is only used
  2261.                when you have activity logging turned on.
  2262.  
  2263.           Aborted: Contains subdirs
  2264.                This message occurs when ShapeShifter fails to convert an
  2265.                archive because it contains subdirs and the archive being
  2266.                converted to doesn't support dirs (or you have ShapeShifter
  2267.                configured not to support them).  Note that this message is
  2268.                only used when you have activity logging turned on.
  2269.  
  2270.           Aborted: Contains attributes
  2271.                This message occurs when ShapeShifter fails to convert an
  2272.                archive because one or more files in the archive have an
  2273.                attribute set, and the archive type you're converting to
  2274.                isn't configured as supporting attributes.  You may also
  2275.                specify the strip attributes option to overcome this
  2276.                problem.  Note that this message is only used when you have
  2277.                activity logging turned on.
  2278.  
  2279.           Aborted: Internal error
  2280.                This message occurs when an internal error in ShapeShifter
  2281.                kept the archive from being properly converted.  Note that
  2282.                this message is only used when you have activity logging
  2283.                turned on.
  2284.  
  2285.           Aborted: User program canceled
  2286.                This message occurs when a user configured program returns a
  2287.                non-zero exit code (causing the conversion of the current
  2288.                archive to be aborted).  Note that this message is only used
  2289.                when you have activity logging turned on.
  2290.  
  2291.           Aborted: VIRUS! INFECTED!
  2292.                This message occurs when the configured virus scanner
  2293.                returns a non-zero exit code after scanning files contained
  2294.                in an archive.  Note that this message is only used when you
  2295.                have activity logging turned on.
  2296.  
  2297.           ShapeShifter - User's Guide                                    41
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.           <ext>: Already defined for archiver (<archiver name>).  Replace?
  2306.                This message is displayed by SSCFG when you save archiver
  2307.                information containing an extension already defined for
  2308.                another archiver.  ShapeShifter only supports one archiver
  2309.                per extension, so it isn't possible to have the same
  2310.                extension listed for use with two different archivers
  2311.                (although you may use different archivers for the create and
  2312.                extract commands since you specify the command line to be
  2313.                used!  Typically this is done for programs such as PKZIP
  2314.                that use separate programs to create and extract files).
  2315.  
  2316.           Archiver name must be specified.
  2317.                This message is displayed by SSCFG when you attempt to save
  2318.                information about an archiver with the archiver name listed
  2319.                as blank.  The archiver name is a mandatory field - if you
  2320.                don't want to save the archiver information abort by
  2321.                pressing ESCape instead of using the F10 key.
  2322.  
  2323.           AttrAbort
  2324.                This message is displayed in the work history window for a
  2325.                file that is not converted since it contains attributes, and
  2326.                the archive type you're converting to isn't configured as
  2327.                supporting attributes.  (Use the strip attributes option to
  2328.                overcome this).
  2329.  
  2330.           -AV File
  2331.                This message is displayed next to a file in the work history
  2332.                window to indicate the file wasn't converted because it
  2333.                contained the PKZIP -AV marking (and you have ShapeShifter
  2334.                configured to leave AV files alone).
  2335.  
  2336.           Both the redo & protect options are set - ignoring the redo
  2337.           option
  2338.                This message is displayed when you specify ShapeShifter
  2339.                should redo existing archives AND keep the old files. 
  2340.                (Since redoing a file implies it will be changed, it is not
  2341.                possible to redo the file and keep the old one too.  This
  2342.                message just lets you know that ShapeShifter is protecting
  2343.                the original files and ignoring the request to redo files
  2344.                that are already in the target format).
  2345.  
  2346.           Complete
  2347.                This message is displayed in the work history window (and
  2348.                log file) indicating a file was successfully converted.
  2349.  
  2350.           Configuration not initialized.  Run SSCFG.
  2351.                Before you use ShapeShifter for the first time you *must*
  2352.                run the configuration program.  Run SSCFG and save the
  2353.                configuration to overcome this message.
  2354.  
  2355.           42                                        ShapeShifter Appendices
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.           Corrupt
  2364.                This message is displayed in the work history window (and
  2365.                log file) indicating an archive was corrupt.  ShapeShifter
  2366.                considers the archive corrupt when the archiver used to
  2367.                extract the files returns a non-zero exit code.
  2368.  
  2369.           CreateErr
  2370.                This message is displayed in the work history window.  It
  2371.                occurs when any of the following happen:
  2372.  
  2373.                     Archiver returns a non-zero exit code when ShapeShifter
  2374.                     asks it to create the new archive.
  2375.  
  2376.                     The target file already exists.  (I.E. you're
  2377.                     converting TEST.ZIP to LZH and TEST.LZH already
  2378.                     exists).
  2379.  
  2380.                     The new archive file can't be found after the
  2381.                     conversion is complete.
  2382.  
  2383.           Create command appears to be missing the archive file name
  2384.           specifier.
  2385.                This message is displayed by SSCFG when you save the
  2386.                information about an archiver if the create command doesn't
  2387.                contain one of the substitution fields to specify the
  2388.                filename.  Since an archiver generally requires the name of
  2389.                the file that should be created you probably should add the
  2390.                proper substitution field so ShapeShifter can tell the
  2391.                archiver which file is being worked on.  (It is suggested
  2392.                you use the %1 field, but other fields are also available).
  2393.  
  2394.           DirAbort
  2395.                This message is displayed in the work history window when an
  2396.                archive conversion is aborted because the archive contains
  2397.                dirs (and the archive type you're converting to doesn't
  2398.                support them OR ShapeShifter is configured to not allow
  2399.                conversion of archives containing subdirs).
  2400.  
  2401.           Error:  Invalid option (X)
  2402.                This message occurs when you specify an invalid command line
  2403.                option (the X is replaced by the letter of the invalid
  2404.                option).
  2405.  
  2406.           EXEC Err
  2407.                This message is displayed in the work history window when an
  2408.                error keeps one of the configured commands from being
  2409.                executed (archiver, virus scanner, and user commands are
  2410.                included).  In general this error means the command you
  2411.                specified either doesn't exist in your path, or there isn't
  2412.  
  2413.           ShapeShifter - User's Guide                                    43
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.                enough memory to run the command.  Memory problems for the
  2422.                archivers can be overcome by using the Switch! option.  If
  2423.                you're having memory problems for other commands - please
  2424.                let me know - if there is a need I can add use of Switch!
  2425.                for all commands.
  2426.  
  2427.           EXEC Failure
  2428.                This message means the same as EXEC Err (listed above),
  2429.                except this message is what appears in the activity log.
  2430.  
  2431.           Extension is blank.  Save record anyway?
  2432.                This message is displayed by SSCFG when you ask to save
  2433.                information about an archiver with a blank extension. 
  2434.                Although this isn't really an error, it's brought to your
  2435.                attention because most archivers use a non-blank extension
  2436.                for archives created.
  2437.  
  2438.           Extract command appears to be missing the archive file name
  2439.           specifier.
  2440.                This message is displayed by SSCFG when you save the
  2441.                information about an archiver if the extract command doesn't
  2442.                contain one of the substitution fields to specify the
  2443.                filename.  Since an archiver generally requires the name of
  2444.                the file that should be extracted you should add the proper
  2445.                substitution field so ShapeShifter can tell the archiver
  2446.                which file is being worked on.  (It is suggested you use the
  2447.                %1 field, but other fields are also available).
  2448.  
  2449.           File length too large.
  2450.                This error message is displayed by SSCFG when the file
  2451.                length (for the user defined BBS dir) is too large.  The
  2452.                maximum value ShapeShifter allows is 70.
  2453.  
  2454.           <file>: Has a size bigger than the size field!  <file size>
  2455.                This error occurs when ShapeShifter is asked to update a dir
  2456.                file that contains a file size field that is defined as
  2457.                being smaller than the minimum required for the file.  (For
  2458.                example, the dir type has a file size of 6 associated with
  2459.                it, and the actual file size is over 999,999 bytes).
  2460.  
  2461.           INFECTED!
  2462.                This is the message that is displayed in the work history
  2463.                window when the virus scanner indicates one or more files
  2464.                inside an archive are infected with a virus.
  2465.  
  2466.           Invalid date stamping method:
  2467.                An invalid date stamping method was specified on the command
  2468.                line.
  2469.  
  2470.  
  2471.           44                                        ShapeShifter Appendices
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.           No file(s) specified/found to convert.
  2480.                This occurs when you don't specify filespecs to convert, or
  2481.                if there aren't any files of a configured archive type that
  2482.                match the filespecs you specify.
  2483.  
  2484.           No matching dir files!
  2485.                This occurs when you have the option set to update a BBS dir
  2486.                file, but no DIR files are found matching the filespecs you
  2487.                configured.
  2488.  
  2489.           Pre command returned error:  <9>  Continue conversion?
  2490.                This message is displayed when the external pre command (the
  2491.                one that is ran before any conversions are done) returns a
  2492.                non-zero exit code.
  2493.  
  2494.           <file>: Read error.
  2495.                There was an error encountered when ShapeShifter tried to
  2496.                read the specified file.
  2497.  
  2498.           RedoAbort
  2499.                This message is displayed in the work history window when
  2500.                ShapeShifter is unable to create a unique extension for a
  2501.                file already in the target format that is being redone. 
  2502.                ShapeShifter tries 1000 different extensions before giving
  2503.                up.
  2504.  
  2505.           Size length too large.
  2506.                This message is displayed by SSCFG when the length of the
  2507.                size field (for the user defined BBS type) exceeds the
  2508.                maximum ShapeShifter allows.  The maximum supported is 20
  2509.                characters.
  2510.  
  2511.           Skipped
  2512.                This message is displayed in the work history window when a
  2513.                file is skipped because it's already in the target format
  2514.                and the redo option is turned off.
  2515.  
  2516.           Skipped: (Already in target format)
  2517.                This message is the same as above except it's the one
  2518.                displayed in the activity log.
  2519.  
  2520.           Skipped: -AV File
  2521.                This message is displayed in the activity log when a file is
  2522.                skipped because it contains PKZIPs AV signature (and you
  2523.                have ShapeShifter configured to leave AV files alone).
  2524.  
  2525.           SysError:
  2526.                This message is displayed in the work history window when an
  2527.                internal ShapeShifter or operating system error occurs.
  2528.  
  2529.           ShapeShifter - User's Guide                                    45
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.           Target archiver create command is blank:
  2538.                This message is displayed when you ask ShapeShifter to
  2539.                convert to an extension that doesn't have a create command
  2540.                specified.
  2541.  
  2542.           Unable to create a temp directory.
  2543.                This error means ShapeShifter was unable to create it's temp
  2544.                work directory for conversion of a file.  (ShapeShifter
  2545.                creates a working directory as a child dir of the path
  2546.                containing the original file to be converted).  If you get
  2547.                this error message your file is either in the root directory
  2548.                of a disk with a completely full root, or is likely on a
  2549.                disk that you don't have write capabilities to (i.e. a
  2550.                network security problem).
  2551.  
  2552.           <file>: Unable to open.
  2553.                This error message occurs when SSCFG can't open the
  2554.                configuration file for reading.
  2555.  
  2556.           Unable to open file for converted files list
  2557.                This message is displayed when ShapeShifter is unable to
  2558.                open the file you specified for saving the list of converted
  2559.                files in.
  2560.  
  2561.           Unable to open log file
  2562.                This message is displayed when ShapeShifter is unable to
  2563.                open the file you specified for activity logging in.
  2564.  
  2565.           Unable to read configuration file.
  2566.                This message means that ShapeShifter can't locate the
  2567.                configuration file (or the file is corrupt).
  2568.  
  2569.           Unable to rename to <file>
  2570.                This message is displayed when the attempt to rename the
  2571.                temp file created while an archive of the target type is
  2572.                redone fails.
  2573.  
  2574.           UserAbort
  2575.                This message is displayed in the work history window when
  2576.                conversion of an archive is aborted because one of the user
  2577.                defined commands returned a non-zero exit code.
  2578.  
  2579.           <file>: Version x.x required to read.
  2580.                This message is displayed if your configuration file was
  2581.                created with a later version of ShapeShifter than you're
  2582.                currently using (and the format was changed).  You should
  2583.                use the same version of ShapeShifter (or a later one) than
  2584.                you use to create the configuration file.
  2585.  
  2586.  
  2587.           46                                        ShapeShifter Appendices
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.           You must define some archivers before saving!
  2596.                This message is displayed by SSCFG if you attempt to save
  2597.                the configuration file while no archivers are defined.
  2598.  
  2599.           You must specify what to convert file(s) to.  Use /EXT=xxx
  2600.                This message is displayed when you run ShapeShifter with an
  2601.                invalid extension specified as the target.  (ShapeShifter
  2602.                requires the target extension to be configured as an
  2603.                archive).
  2604.  
  2605.           You probably need to specify *.* in the create command.  
  2606.                This message is displayed by SSCFG when you ask to save the
  2607.                current archiver information and the create command doesn't
  2608.                contain *.* in it.  For most archivers you need to specify
  2609.                the files to add to the newly created archive (which means
  2610.                you should have *.* in your command line).
  2611.  
  2612.           <file>: Write error.
  2613.                This message is displayed by SSCFG when an error occurs
  2614.                writing the configuration file.
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.           ShapeShifter - User's Guide                                    47
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.           Appendix D - Specifying Command Lines
  2654.  
  2655.           Several of ShapeShifter's options are intended to contain a
  2656.           command line.  In ShapeShifter the text you type as the command
  2657.           line is handled to look as if you typed it at the DOS prompt -
  2658.           with an important exception.  Before passing the command line to
  2659.           DOS, ShapeShifter first examines the command line to determine
  2660.           the location of fields such as the current filename.
  2661.  
  2662.           To allow you to specify where things like the filename should go,
  2663.           ShapeShifter supports a type of field substitution.  The
  2664.           following table lists fields that ShapeShifter supports.  When
  2665.           ShapeShifter encounters the text in a command line option it will
  2666.           perform the substitution listed in the table.  (Note that it
  2667.           doesn't matter if there are spaces before or after the field in
  2668.           the command line.  In addition, case is not sensitive.  You may
  2669.           specify the fields using upper or lower case):
  2670.  
  2671.                Field     Value that is substituted
  2672.                -----     -------------------------
  2673.                %1        The full path of the file (includes the filename
  2674.                          and extension).
  2675.  
  2676.                %D        Drive letter of the file currently being
  2677.                          converted.
  2678.  
  2679.                %E        The extension of the file that's being converted.
  2680.  
  2681.                %F        Filename that's being converted (without the
  2682.                          extension).
  2683.  
  2684.                %N        The filename and extension that's being converted.
  2685.  
  2686.                %P        Directory of the file being converted.
  2687.  
  2688.                %%        Sends a single percent sign.  This allows you to
  2689.                          override the substitution that ShapeShifter
  2690.                          normally performs when a field listed above is
  2691.                          required in the command line.  For instance, if
  2692.                          your command line contains %%D, ShapeShifter will
  2693.                          send %D to the command line instead of
  2694.                          substituting the drive for %D.
  2695.  
  2696.  
  2697.           Notes:    The extension that's substituted (for any field that
  2698.                     contains an extension) depends on where in the
  2699.                     conversion process you are.  The extension you're
  2700.                     converting to is substituted in the following commands:
  2701.  
  2702.  
  2703.           48                                        ShapeShifter Appendices
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.                          Archive create command
  2712.  
  2713.                          Command to execute after extracting an archive
  2714.  
  2715.                          Command to execute after creating an archive
  2716.  
  2717.                     For the extract command as well as the command to
  2718.                     execute before extracting an archive, the original file
  2719.                     extension is substituted.
  2720.  
  2721.           Commands that don't appear on the archiver options screen in
  2722.           SSCFG don't have valid values for the fields listed above (i.e.
  2723.           this includes the scanner command, command to execute before
  2724.           beginning the conversion, and the command to execute after all
  2725.           conversions are done).  If any of the fields are specified in
  2726.           these command lines, they will be removed.
  2727.  
  2728.  
  2729.           Example Command Lines
  2730.  
  2731.           The following examples assume that you're converting a file
  2732.           called IC186.ZIP to IC186.LZH.  For the examples, the directory
  2733.           IC186.ZIP is in is:  D:\CATALOG.
  2734.  
  2735.           Command Line        Field This Command Line Is In
  2736.           ------------        -----------------------------
  2737.           mycmd %f %e         Command to execute before extracting the
  2738.                               archive.
  2739.  
  2740.                Resulting command line that's executed: mycmd IC186 ZIP
  2741.           ----------------------------------------------
  2742.           mycmd %f %e         Command to execute after extracting the
  2743.                               archive.
  2744.  
  2745.                Resulting command line that's executed: mycmd IC186 LZH
  2746.           ----------------------------------------------
  2747.           pkunzip %1          Archive extract command
  2748.  
  2749.                Resulting command line that's executed: 
  2750.  
  2751.                     pkunzip D:\CATALOG\IC186.ZIP
  2752.           ----------------------------------------------
  2753.           lha a %1 *.*        Archive create command
  2754.  
  2755.                Resulting command line that's executed:
  2756.  
  2757.                     lha a D:\CATALOG\IC186.LZH *.*
  2758.           ----------------------------------------------
  2759.  
  2760.  
  2761.           ShapeShifter - User's Guide                                    49
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.           mycmd %1 %%1        Command to execute after archive is created
  2770.  
  2771.                Resulting command line that's executed:
  2772.  
  2773.                     mycmd D:\CATALOG\IC186.LZH %1
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.           50                                        ShapeShifter Appendices
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.                                                                       Index
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.           activity logging
  2841.                setting level  24
  2842.           age of files
  2843.                specifying  25
  2844.           archive to convert to
  2845.                specifying  18
  2846.           archiver
  2847.                create command  18
  2848.                extract command  22
  2849.                support dir option 
  2850.                     32
  2851.           archiver name
  2852.                option  13
  2853.           archives
  2854.                detecting corrupt 
  2855.                     38
  2856.                recursing  27
  2857.                redoing  29
  2858.           attributes
  2859.                stripping  31
  2860.           author verification
  2861.                option  14
  2862.           author verified files
  2863.                preserving  26
  2864.           AV files
  2865.                preserving  26
  2866.           bad files directory
  2867.                option  14
  2868.           bbs
  2869.                support  6
  2870.           BBS DIR
  2871.                specifying type  20
  2872.                update option  33
  2873.           command lines
  2874.                specifying  48
  2875.           convert archives with
  2876.                     subdirs
  2877.                option  18
  2878.           convert to
  2879.                option  18
  2880.           converted files
  2881.                create list of  19
  2882.           converted list filename
  2883.                option  29
  2884.           corrupt archives
  2885.                detecting  38
  2886.           create command
  2887.                option  18
  2888.           date stamping                           option  19
  2889.                                              dir 
  2890.                                                   size start,len
  2891.                                                        option  31
  2892.                                              dir file
  2893.                                                   file start,len
  2894.                                                        options  23
  2895.                                                   option  20
  2896.                                                   r. just option  26
  2897.                                                   update option  33
  2898.                                              dir type
  2899.                                                   option  20
  2900.                                              dirs
  2901.                                                   archiver support  32
  2902.                                              EMS
  2903.                                                   Switch!ing to  32
  2904.                                              equipment
  2905.                                                   required  6
  2906.                                              error messages  41
  2907.                                                   work history window 
  2908.                                                        38
  2909.                                              extension
  2910.                                                   converting to  18
  2911.                                                   option  22
  2912.                                              extract command
  2913.                                                   option  22
  2914.                                              features  7
  2915.                                              field substitution
  2916.                                                   in command lines  48
  2917.                                              file attributes
  2918.                                                   archiver option  22
  2919.                                              file start,len
  2920.                                                   option  23
  2921.                                              i/o redirection  28
  2922.                                              keep original archive
  2923.                                                   option  23
  2924.                                              license  4
  2925.                                              log filename
  2926.                                                   option  24
  2927.                                              logging level
  2928.                                                   option  24
  2929.                                              max age of files to
  2930.                                                        convert
  2931.                                                   option  25
  2932.                                              memory
  2933.                                                   making available  26
  2934.                                              memory to make available
  2935.                                                   option  26
  2936.                                              options
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.                archiver name  13
  2945.                author verification 
  2946.                     14
  2947.                bad files directory 
  2948.                     14
  2949.                command line  11
  2950.                command to execute
  2951.                     before
  2952.                     conversion  16
  2953.                convert archives
  2954.                     with subdirs 
  2955.                     18
  2956.                convert to  18
  2957.                converted list
  2958.                     filename  29
  2959.                create command  18
  2960.                create list of
  2961.                     converted files 
  2962.                     19
  2963.                date stamping  19
  2964.                dir file  20
  2965.                dir type  20
  2966.                extension (of
  2967.                     archiver)  22
  2968.                extract command  22
  2969.                file attributes  22
  2970.                file start,len  23
  2971.                keep original
  2972.                     archive  23
  2973.                log filename  24
  2974.                logging level  24
  2975.                max age of files  25
  2976.                memory to make
  2977.                     available  26
  2978.                overview  10
  2979.                preserve author
  2980.                     verified files 
  2981.                     26
  2982.                r. just  26
  2983.                recurse archives  27
  2984.                recurse subdirs  27
  2985.                redirect i/o  28
  2986.                redo archives  29
  2987.                scanner command  29
  2988.                scanner supports
  2989.                     dirs  30
  2990.                size start,len  31
  2991.                specifying  12
  2992.                strip attributes  31               subdirs (archiver
  2993.                                                        support)  32
  2994.                                                   Switch! to ems  32
  2995.                                                   Switch! to xms  33
  2996.                                                   test only  33
  2997.                                                   update bbs dir  33
  2998.                                                   use 43/50 line mode 
  2999.                                                        34
  3000.                                                   use Switch!  34
  3001.                                                   use virus scanner 
  3002.                                                        36
  3003.                                              parameter
  3004.                                                   types  10
  3005.                                              preserve author verified
  3006.                                                        files
  3007.                                                   option  26
  3008.                                              protecting
  3009.                                                   original file  23
  3010.                                              purchasing  9
  3011.                                              r. just
  3012.                                                   option  26
  3013.                                              recurse archives
  3014.                                                   option  27
  3015.                                              recurse subdirs
  3016.                                                   option  27
  3017.                                              redirect i/o
  3018.                                                   option  28
  3019.                                              redo archives
  3020.                                                   option  29
  3021.                                              registering  9
  3022.                                              required equipment  6
  3023.                                              scanner command
  3024.                                                   option  29
  3025.                                              scanner supports dirs
  3026.                                                   option  30
  3027.                                              size start,len
  3028.                                                   dir option  31
  3029.                                              specifying
  3030.                                                   age of files   25
  3031.                                                   archive to convert
  3032.                                                        to  18
  3033.                                                   BBS dir filename  20
  3034.                                                   BBS dir type  20
  3035.                                                   command lines  48
  3036.                                                   date stamp method 
  3037.                                                        19
  3038.                                              Starting ShapeShifter  10
  3039.                                              strip attributes
  3040.                                                   option  31
  3041.  
  3042.           ShapeShifter - User's Guide                                    53
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.           subdirs
  3051.                recursing   27
  3052.                support option  18
  3053.           subdirs (archiver
  3054.                     support)
  3055.                option  32
  3056.           support
  3057.                getting  6
  3058.           Switch! to EMS
  3059.                option  32
  3060.           Switch! to xms
  3061.                option  33
  3062.           test only
  3063.                option  33
  3064.           update bbs dir
  3065.                option  33
  3066.           use 43/50 lines
  3067.                option  34
  3068.           use Switch!
  3069.                option  34
  3070.           use virus scanner
  3071.                option  36
  3072.           virus scanner
  3073.                command  29
  3074.                using  36
  3075.           warranty  5
  3076.           XMS
  3077.                Switch!ing to  33
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.           54
  3101.